Re: [PATCH 0/4] extcon: Modify the name of unused external connector

[Chanwoo Choi <cw00.choi@samsung.com>]

On 04/30/2015 11:10 AM, Krzysztof Kozlowski wrote:
> On 28.04.2015 17:40, Chanwoo Choi wrote:
>> On Tue, Apr 28, 2015 at 12:43 PM, Krzysztof Kozlowski
>> <k.kozlowski@samsung.com> wrote:
>>> On 27.04.2015 21:31, Chanwoo Choi wrote:
>>>>
>>>> This patchset alter the unused name of external connector (jig/dock/MHL)
>>>> as
>>>> following. The name of jig cable and dock device include the non-standard
>>>> H/W
>>>> information. On user-space side, this information are not necessary. The
>>>> extcon
>>>> core will support the other method to inform the specific H/W information
>>>> to
>>>> kernel device driver and framework. For example, extcon core have the plan
>>>> to add
>>>> the notifier chain for USB ID/VBUS pin state. If extcon consumer (kernel
>>>> device
>>>> driver and framework) use the notifer chain for USB ID/VBUS, they can get
>>>> the
>>>> state of both JIG and USB when JIG-USB-ON cable is attached.
>>>>
>>>> And last patch removes the unused 'num_cables' filed on extcon-adc-jack.c.
>>>>
>>>> 1. jig cable name
>>>> - JIG-USB-ON   -->|
>>>> - JIG-USB-OFF  -->|
>>>> - JIG-UART-ON  -->|
>>>> - JIG-UART-OFF -->|--> JIG
>>>>
>>>> 2. dock device name
>>>> - Dock-Smart   -->|
>>>> - Dock-Desk    -->|
>>>> - Dock-Audio   -->|
>>>> - Dock-Card    -->|--> DOCK
>>>>
>>>> 3. MHL-TA cable name
>>>> - MHL-TA -> TA
>>>
>>>
>>> Hi,
>>>
>>> That makes sense but isn't such change a break of interface with user-space?
>>> The user-space may expect Dock-xxx for Dock.
>>
>> I guess it's possible. But, the "Dock-{Smart|Desk|Audio}" device name are not
>> standard. Their name are only used for Samsung Galaxy S3 (releaesd 3.0
>> kernel) and it is not for mainline kernel.
>>
>> So, I want to make the standard cable name for mainline kernel and user-space.
>> The extcon driver will send the event of 'dock' device with specific
>> external connector which is connected to 'dock' device.
>>
>> For example, Dock-Smart means the Dock device with MHL cable. When
>> Dock-Smart is attached, extcon driver will send the two external
>> connector state of
>> both 'DOCK' and 'MHL'. So, the user-space process will detect the kind of dock
>> by catching both 'DOCK' and 'MHL' uevent.
> 
> Okay, one more concern - for Dock-Smart the extcon will send two consecutive events (first DOCK, then MHL). So to distinguish this from two separate connections of Dock and MHL (user first connects some Dock, disconnects, connects MHL), the driver always has to call extcon_set_cable_state(edev, "Dock", false) after disconnection.
> 
> Without the "disconnect" state this case would mean for userspace "Dock+MHL".
> 
> This looks like an important part of API for extcon and for driver implementations. So it should be documented somewhere?

There is no document about it. I'll send other patch for the sequence of two events as following:

- attached
1. DOCK is attached
2. MHL is attached
- detached
1. MHL is detached
2. DOCK is detached

Thanks,
Chanwoo Choi