← Documents Documentation/ABI/testing/sysfs-platform-kim GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

TI KIM shared UART transport sysfs ABI

TI WL128x shared UART의 device name, baud rate, flow control과 Bluetooth·FM·GPS line-discipline 설치 handshake를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-platform-kim
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

WL128x UART configuration

sysfs-platform-kim:1-35

Board가 전달한 UART device name, platform별 reliable baud rate와 flow-control capability를 userspace daemon에 제공합니다.

Shared transport install handshake

sysfs-platform-kim:36-49

Bluetooth·FM·GPS client 등록을 1/0 install state와 sysfs_notify로 userspace UART lifecycle에 연결합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

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

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

TI KIM shared UART transport sysfs ABI: dev name

1-13
항목한국어 전문 번역
What/sys/devices/platform/kim/dev_name
Date2010년 1월
KernelVersion2.6.38
Contact"Pavan Savoy" <pavan_savoy@ti.com>
Description`/sys/devices/platform/kim/dev_name`은 WL128x chip이 연결된 UART device의 name을 담습니다. 예시는 `/dev/ttyS0`입니다. Device name은 ATAGS bootloader firmware에서 architecture-specific board initialization file로 전달됩니다. 노출된 name을 userspace daemon이 읽고, install이 요청되면 해당 device를 엽니다.
KIM UART configuration entries
EntryPurposeExample or typical value
dev_nameConnected UART device/dev/ttyS0
baud_rateMaximum reliable host ratePlatform-specific
flow_cntrlUART flow-control useUsually 1

Userspace daemon이 shared transport를 열기 전에 읽는 platform values입니다.

TI KIM shared UART transport sysfs ABI: baud rate

14-25
항목한국어 전문 번역
What/sys/devices/platform/kim/baud_rate
Date2010년 1월
KernelVersion2.6.38
Contact"Pavan Savoy" <pavan_savoy@ti.com>
Description`/sys/devices/platform/kim/baud_rate`는 host가 안정적으로 지원할 수 있는 maximum baud rate입니다. Platform마다 high-speed UART configuration이 다르므로 baud rate를 locally 설정하고 HCI-VS command를 통해 WL128x에도 보내야 합니다. Userspace daemon은 ldisc install이 요청되면 이 entry를 읽어 사용합니다.

TI KIM shared UART transport sysfs ABI: flow cntrl

26-35
항목한국어 전문 번역
What/sys/devices/platform/kim/flow_cntrl
Date2010년 1월
KernelVersion2.6.38
Contact"Pavan Savoy" <pavan_savoy@ti.com>
Description`/sys/devices/platform/kim/flow_cntrl`은 WL128x의 flow-control mechanism 사용 여부를 나타냅니다. 대부분 `1`이어야 하며 host UART가 flow control capability를 가져야 합니다. 그렇지 않은 예외에서는 이 entry를 사용할 수 있습니다.

TI KIM shared UART transport sysfs ABI: install

36-49
항목한국어 전문 번역
What/sys/devices/platform/kim/install
Date2010년 1월
KernelVersion2.6.38
Contact"Pavan Savoy" <pavan_savoy@ti.com>
Description`/sys/devices/platform/kim/install`은 Bluetooth, FM 또는 GPS protocol 중 하나가 shared UART transport를 사용하려 할 때의 install handshake입니다. Protocol은 shared transport driver에 register하고, driver는 userspace에 UART open, baud configuration과 line discipline install을 이 sysfs entry로 signal합니다. UART 관리 daemon이 이 entry를 poll하며 `sysfs_notify`로 change notification을 받습니다. Value `1`은 UART를 열고 ldisc를 install해야 함을, `0`은 UART가 더 이상 필요하지 않아 닫아야 함을 뜻합니다.
KIM line-discipline lifecycle
Bluetooth, FM or GPS registersShared transport signals userspaceinstall = 1Open UART, set baud, install ldisc
UART no longer requiredsysfs_notify changeinstall = 0Close UART

Protocol demand가 install value를 통해 userspace UART open·close operation으로 이어집니다.