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