SIOX bus and chained device attributes | Linux 6.18.37

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

1. 요약·해설

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

Active state, dynamic devices, and polling

sysfs-bus-siox:1-44

Bus를 정지하거나 주기적 push-pull cycle로 운용하고, 장치를 chain 끝에 추가·제거하며 poll 간격을 jiffies 정밀도로 설정합니다.

Connection, registers, status, and watchdog

sysfs-bus-siox:45-90

각 장치의 연결 상태, input/output byte 수, driver matching type, status 오류와 watchdog reset 상태·오류 횟수를 노출합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 What: /sys/bus/siox/devices/siox-X/active

2 KernelVersion: 4.16

3 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

4 Description:

5 On reading represents the current state of the bus. If it

6 contains a "0" the bus is stopped and connected devices are

7 expected to not do anything because their watchdog triggered.

8 When the file contains a "1" the bus is operated and periodically

9 does a push-pull cycle to write and read data from the

10 connected devices.

12 When writing a "0" or "1" the bus moves to the described state.

14 What: /sys/bus/siox/devices/siox-X/device_add

15 KernelVersion: 4.16

16 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

17 Description:

18 Write-only file. Write

20 <type> <inbytes> <outbytes> <statustype>

22 to add a new device dynamically. <type> is the name that is used to match

23 to a driver (similar to the platform bus). <inbytes> and <outbytes> define

24 the length of the input and output shift register in bytes respectively.

26 <statustype> defines the 4 bit device type that is check to identify connection

27 problems.

29 The new device is added to the end of the existing chain.

31 What: /sys/bus/siox/devices/siox-X/device_remove

32 KernelVersion: 4.16

33 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

34 Description:

35 Write-only file. A single write removes the last device in the siox chain.

37 What: /sys/bus/siox/devices/siox-X/poll_interval_ns

38 KernelVersion: 4.16

39 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

40 Description:

41 Defines the interval between two poll cycles in nano seconds.

42 Note this is rounded to jiffies on writing. On reading the current value

43 is returned.

45 What: /sys/bus/siox/devices/siox-X-Y/connected

46 KernelVersion: 4.16

47 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

48 Description:

49 Read-only value. "0" means the Yth device on siox bus X isn't "connected" i.e.

50 communication with it is not ensured. "1" signals a working connection.

52 What: /sys/bus/siox/devices/siox-X-Y/inbytes

53 KernelVersion: 4.16

54 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

55 Description:

56 Read-only value reporting the inbytes value provided to siox-X/device_add

58 What: /sys/bus/siox/devices/siox-X-Y/status_errors

59 KernelVersion: 4.16

60 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

61 Description:

62 Counts the number of time intervals when the read status byte doesn't yield the

63 expected value.

65 What: /sys/bus/siox/devices/siox-X-Y/type

66 KernelVersion: 4.16

67 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

68 Description:

69 Read-only value reporting the type value provided to siox-X/device_add.

71 What: /sys/bus/siox/devices/siox-X-Y/watchdog

72 KernelVersion: 4.16

73 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

74 Description:

75 Read-only value reporting if the watchdog of the siox device is

76 active. "0" means the watchdog is not active and the device is expected to

77 be operational. "1" means the watchdog keeps the device in reset.

79 What: /sys/bus/siox/devices/siox-X-Y/watchdog_errors

80 KernelVersion: 4.16

81 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

82 Description:

83 Read-only value reporting the number to time intervals when the

84 watchdog was active.

86 What: /sys/bus/siox/devices/siox-X-Y/outbytes

87 KernelVersion: 4.16

88 Contact: Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>

89 Description:

90 Read-only value reporting the outbytes value provided to siox-X/device_add.

3. 한국어 전문 번역

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

SIOX bus 동작 상태

1-13

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X/active
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	읽으면 현재 bus 상태를 나타냅니다. 값이 "0"이면 bus가 정지했으며, 연결 장치는 watchdog이 trigger되어 아무 동작도 하지 않는 것으로 기대됩니다. 값이 "1"이면 bus가 동작하고 연결 장치에 data를 쓰고 읽기 위해 주기적으로 push-pull cycle을 수행합니다. "0" 또는 "1"을 쓰면 bus가 해당 상태로 전환됩니다.

SIOX device 동적 추가

14-30

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X/device_add
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	쓰기 전용 file입니다. 아래 형식을 쓰면 새 장치를 동적으로 추가합니다. <type>은 platform bus와 비슷하게 driver match에 사용하는 이름입니다. <inbytes>와 <outbytes>는 각각 input과 output shift register 길이를 byte 단위로 정의합니다. <statustype>은 연결 문제를 식별할 때 검사하는 4-bit device type을 정의합니다. 새 장치는 기존 chain의 끝에 추가됩니다.

<type> <inbytes> <outbytes> <statustype>

SIOX chain 마지막 장치 제거

31-36

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X/device_remove
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	쓰기 전용 file입니다. 한 번 쓰면 SIOX chain의 마지막 장치를 제거합니다.

SIOX poll cycle 간격

37-44

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X/poll_interval_ns
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	두 poll cycle 사이의 간격을 nanosecond 단위로 정의합니다. 쓸 때 jiffies 단위로 반올림되며 읽으면 현재 값을 반환합니다.

SIOX 장치 연결 상태

45-51

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X-Y/connected
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	읽기 전용 값입니다. "0"은 SIOX bus X의 Y번째 장치가 connected 상태가 아니어서 통신을 보장할 수 없다는 뜻이고, "1"은 연결이 정상 동작함을 나타냅니다.

SIOX input shift register 길이

52-57

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X-Y/inbytes
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	읽기 전용 값으로 siox-X/device_add에 전달한 inbytes 값을 보고합니다.

SIOX status byte 오류 횟수

58-64

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X-Y/status_errors
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	읽은 status byte가 기대한 값을 내지 않은 시간 간격의 수를 계산합니다.

SIOX driver matching type

65-70

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X-Y/type
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	읽기 전용 값으로 siox-X/device_add에 전달한 type 값을 보고합니다.

SIOX device watchdog 상태

71-78

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X-Y/watchdog
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	읽기 전용 값으로 SIOX 장치의 watchdog이 active인지 보고합니다. "0"은 watchdog이 active하지 않아 장치가 정상 동작할 것으로 기대된다는 뜻이고, "1"은 watchdog이 장치를 reset 상태로 유지한다는 뜻입니다.

SIOX watchdog active 간격 횟수

79-85

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X-Y/watchdog_errors
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	읽기 전용 값으로 watchdog이 active했던 시간 간격의 수를 보고합니다.

SIOX output shift register 길이

86-90

항목	한국어 전문 번역
What	/sys/bus/siox/devices/siox-X-Y/outbytes
Date	원문에 명시되지 않음
KernelVersion	4.16
Contact	Thorsten Scherer <[email protected]>, Uwe Kleine-König <[email protected]>
Description	읽기 전용 값으로 siox-X/device_add에 전달한 outbytes 값을 보고합니다.