PSARC/2009/266 Edgeport USB serial mode configuration

[Artem Kachitchkine]

Timeout is approaching: there's been a bit of discussion and so far 
we've got one abstain (Garrett) and no other votes.

-Artem

On 04/28/09 15:07, Artem Kachitchkine wrote:
> 
> I'm sponsoring this fasttrack for Guoqing Zhu. The timer is set for 
> 05/06/2009.
> 
> My understanding is that even though the initial delivery is for 
> usbser_edge driver, the proposed interface can be adopted by other USB 
> serial drivers and new modes added in the future.
> 
> -Artem
> 
> Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
> This information is Copyright 2009 Sun Microsystems
> 1. Introduction
>     1.1. Project/Component Working Name:
>      Edgeport USB serial mode configuration
>     1.2. Name of Document Author/Supplier:
>      Author:  Guoqing Zhu
>     1.3  Date of This Document:
>     28 April, 2009
> 4. Technical Description
> 4.1. Summary
> 
> Support Edgeport USB serial devices RS232/422/485 mode switching mode
> via usbser_edge.conf.
> 
> Requested binding: patch.
> 
> 
> 4.2 Details
> 
> Most Edgeport USBSerial devices only work in RS232 mode, except that two
> Edgeport devices, Edgeport 4S and Edgeport 8S, can work in RS232/422/485
> mode. But current usbser_edge driver only supports RS232 mode. There 
> needs to be a way to configure which mode the device should operate in.
> 
> We propose to create a new usbser_edge.conf property called portflag,
> a comma-separated string array, each string in the following format:
> 
> "serialnumber=SerNum portnumber=PortNum mode=Mode"
> 
> where:
> 
> SerNum: USB serial number, can be obtained from the 'usb-serialno'
> property from prtconf(1M) output.
> 
> PortNum: serial port number
> 
> Mode - could be following strings corresponding to the modes
>     supported by the device's firmware:
> 
>     RS232
>     RS422_NOTERM
>     RS422_TERM
>     RS485_HALF_ECHO_ENDUNIT
>     RS485_HALF_NOECHO_ENDUNIT
>     RS485_HALF_ECHO_MIDDLE
>     RS485_HALF_NOECHO_MIDDLE
>     RS485_FULL_MASTER_ENDUNIT
>     RS485_FULL_SLAVE_ENDUNIT
>     RS485_FULL_MASTER_MIDDLE
>     RS485_FULL_SLAVE_MIDDLE
> 
> For example, set device (SN: W84662767-0) port 0 to RS422_NOTERM mode:
> 
> portflag=
> "serialnumber=W84662767-0 portnumber=0 mode=RS422_NOTERM";
> 
> 
> 5. Interfaces
> 
> Name      | Classification | Description
> ----------+----------------+-------------------------------
> portflag  |     Stable     | driver.conf property
> ----------+----------------+-------------------------------
> 
> Requested binding: patch.
> 
> 6. Resources and Schedule
>     6.4. Steering Committee requested information
>        6.4.1. Consolidation C-team Name:
>         ON
>     6.5. ARC review type: FastTrack
>     6.6. ARC Exposure: open
>