xref: /linux/Documentation/ABI/testing/sysfs-platform-kim (revision 4413e16d9d21673bb5048a2e542f1aaa00015c2e)
1What:		/sys/devices/platform/kim/dev_name
2Date:		January 2010
3KernelVersion:	2.6.38
4Contact:	"Pavan Savoy" <pavan_savoy@ti.com>
5Description:
6		Name of the UART device at which the WL128x chip
7		is connected. example: "/dev/ttyS0".
8		The device name flows down to architecture specific board
9		initialization file from the SFI/ATAGS bootloader
10		firmware. The name exposed is read from the user-space
11		dameon and opens the device when install is requested.
12
13What:		/sys/devices/platform/kim/baud_rate
14Date:		January 2010
15KernelVersion:	2.6.38
16Contact:	"Pavan Savoy" <pavan_savoy@ti.com>
17Description:
18		The maximum reliable baud-rate the host can support.
19		Different platforms tend to have different high-speed
20		UART configurations, so the baud-rate needs to be set
21		locally and also sent across to the WL128x via a HCI-VS
22		command. The entry is read and made use by the user-space
23		daemon when the ldisc install is requested.
24
25What:		/sys/devices/platform/kim/flow_cntrl
26Date:		January 2010
27KernelVersion:	2.6.38
28Contact:	"Pavan Savoy" <pavan_savoy@ti.com>
29Description:
30		The WL128x makes use of flow control mechanism, and this
31		entry most often should be 1, the host's UART is required
32		to have the capability of flow-control, or else this
33		entry can be made use of for exceptions.
34
35What:		/sys/devices/platform/kim/install
36Date:		January 2010
37KernelVersion:	2.6.38
38Contact:	"Pavan Savoy" <pavan_savoy@ti.com>
39Description:
40		When one of the protocols Bluetooth, FM or GPS wants to make
41		use of the shared UART transport, it registers to the shared
42		transport driver, which will signal the user-space for opening,
43		configuring baud and install line discipline via this sysfs
44		entry. This entry would be polled upon by the user-space
45		daemon managing the UART, and is notified about the change
46		by the sysfs_notify. The value would be '1' when UART needs
47		to be opened/ldisc installed, and would be '0' when UART
48		is no more required and needs to be closed.
49