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
