SoundWire Slave status and DisCo properties | Linux 6.18.37

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

1. 요약·해설

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

Detect firmware and physical enumeration mismatches

sysfs-bus-soundwire-slave:1-18

Status와 device_number는 firmware 노출과 실제 bus enumeration이 일치하지 않는 장치를 식별하는 데 쓰입니다.

Configure Slave capabilities

sysfs-bus-soundwire-slave:19-47

MIPI revision, wake·test·clock-stop capability, timeout, reset·paging·bank behavior와 source/sink port bitmap을 제공합니다.

Configure Data Port 0 and Source/Sink Port N

sysfs-bus-soundwire-slave:48-109

Data Port 0과 각 Source·Sink Port의 word·channel·grouping·buffer·encoding 및 channel-prepare 속성을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 What: /sys/bus/soundwire/devices/sdw:.../status

2 /sys/bus/soundwire/devices/sdw:.../device_number

4 Date: September 2020

6 Contact: Pierre-Louis Bossart <[email protected]>

7 Bard Liao <[email protected]>

8 Vinod Koul <[email protected]>

10 Description: SoundWire Slave status

12 These properties report the Slave status, e.g. if it

13 is UNATTACHED or not, and in the latter case show the

14 device_number. This status information is useful to

15 detect devices exposed by platform firmware but not

16 physically present on the bus, and conversely devices

17 not exposed in platform firmware but enumerated.

19 What: /sys/bus/soundwire/devices/sdw:.../dev-properties/mipi_revision

20 /sys/bus/soundwire/devices/sdw:.../dev-properties/wake_capable

21 /sys/bus/soundwire/devices/sdw:.../dev-properties/test_mode_capable

22 /sys/bus/soundwire/devices/sdw:.../dev-properties/clk_stop_mode1

23 /sys/bus/soundwire/devices/sdw:.../dev-properties/simple_clk_stop_capable

24 /sys/bus/soundwire/devices/sdw:.../dev-properties/clk_stop_timeout

25 /sys/bus/soundwire/devices/sdw:.../dev-properties/ch_prep_timeout

26 /sys/bus/soundwire/devices/sdw:.../dev-properties/reset_behave

27 /sys/bus/soundwire/devices/sdw:.../dev-properties/high_PHY_capable

28 /sys/bus/soundwire/devices/sdw:.../dev-properties/paging_support

29 /sys/bus/soundwire/devices/sdw:.../dev-properties/bank_delay_support

30 /sys/bus/soundwire/devices/sdw:.../dev-properties/p15_behave

31 /sys/bus/soundwire/devices/sdw:.../dev-properties/master_count

32 /sys/bus/soundwire/devices/sdw:.../dev-properties/source_ports

33 /sys/bus/soundwire/devices/sdw:.../dev-properties/sink_ports

35 Date: May 2020

37 Contact: Pierre-Louis Bossart <[email protected]>

38 Bard Liao <[email protected]>

39 Vinod Koul <[email protected]>

41 Description: SoundWire Slave DisCo properties.

42 These properties are defined by MIPI DisCo Specification

43 for SoundWire. They define various properties of the

44 SoundWire Slave and are used by the bus to configure

45 the Slave

48 What: /sys/bus/soundwire/devices/sdw:.../dp0/max_word

49 /sys/bus/soundwire/devices/sdw:.../dp0/min_word

50 /sys/bus/soundwire/devices/sdw:.../dp0/words

51 /sys/bus/soundwire/devices/sdw:.../dp0/BRA_flow_controlled

52 /sys/bus/soundwire/devices/sdw:.../dp0/simple_ch_prep_sm

53 /sys/bus/soundwire/devices/sdw:.../dp0/imp_def_interrupts

55 Date: May 2020

57 Contact: Pierre-Louis Bossart <[email protected]>

58 Bard Liao <[email protected]>

59 Vinod Koul <[email protected]>

61 Description: SoundWire Slave Data Port-0 DisCo properties.

62 These properties are defined by MIPI DisCo Specification

63 for the SoundWire. They define various properties of the

64 Data port 0 are used by the bus to configure the Data Port 0.

67 What: /sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_word

68 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/min_word

69 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/words

70 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/type

71 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_grouping

72 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/simple_ch_prep_sm

73 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/ch_prep_timeout

74 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/imp_def_interrupts

75 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/min_ch

76 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_ch

77 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/channels

78 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/ch_combinations

79 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_async_buffer

80 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/block_pack_mode

81 /sys/bus/soundwire/devices/sdw:.../dp<N>_src/port_encoding

83 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_word

84 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/min_word

85 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/words

86 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/type

87 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_grouping

88 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/simple_ch_prep_sm

89 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/ch_prep_timeout

90 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/imp_def_interrupts

91 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/min_ch

92 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_ch

93 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/channels

94 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/ch_combinations

95 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_async_buffer

96 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/block_pack_mode

97 /sys/bus/soundwire/devices/sdw:.../dp<N>_sink/port_encoding

99 Date: May 2020

100

101 Contact: Pierre-Louis Bossart <[email protected]>

102 Bard Liao <[email protected]>

103 Vinod Koul <[email protected]>

104

105 Description: SoundWire Slave Data Source/Sink Port-N DisCo properties.

106 These properties are defined by MIPI DisCo Specification

107 for SoundWire. They define various properties of the

108 Source/Sink Data port N and are used by the bus to configure

109 the Data Port N.

110

3. 한국어 전문 번역

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

SoundWire Slave 상태와 device number

1-18

항목	한국어 전문 번역
What	/sys/bus/soundwire/devices/sdw:.../status
What	/sys/bus/soundwire/devices/sdw:.../device_number
Date	2020년 9월
Contact	Pierre-Louis Bossart <[email protected]>, Bard Liao <[email protected]>, Vinod Koul <[email protected]>
Description	SoundWire Slave 상태를 보고합니다. 예를 들어 Slave가 UNATTACHED인지 표시하고, 그렇지 않으면 device_number를 보여 줍니다. 이 상태 정보는 platform firmware에 노출됐지만 bus에 물리적으로 존재하지 않는 장치와, 반대로 platform firmware에는 없지만 enumeration된 장치를 감지하는 데 유용합니다.

SoundWire Slave DisCo 속성

19-47

항목	한국어 전문 번역
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/mipi_revision
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/wake_capable
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/test_mode_capable
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/clk_stop_mode1
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/simple_clk_stop_capable
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/clk_stop_timeout
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/ch_prep_timeout
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/reset_behave
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/high_PHY_capable
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/paging_support
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/bank_delay_support
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/p15_behave
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/master_count
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/source_ports
What	/sys/bus/soundwire/devices/sdw:.../dev-properties/sink_ports
Date	2020년 5월
Contact	Pierre-Louis Bossart <[email protected]>, Bard Liao <[email protected]>, Vinod Koul <[email protected]>
Description	SoundWire Slave의 DisCo 속성입니다. MIPI DisCo Specification for SoundWire가 정의하며 SoundWire Slave의 여러 속성을 나타내고 bus가 Slave를 구성할 때 사용합니다.

SoundWire Slave Data Port 0 속성

48-66

항목	한국어 전문 번역
What	/sys/bus/soundwire/devices/sdw:.../dp0/max_word
What	/sys/bus/soundwire/devices/sdw:.../dp0/min_word
What	/sys/bus/soundwire/devices/sdw:.../dp0/words
What	/sys/bus/soundwire/devices/sdw:.../dp0/BRA_flow_controlled
What	/sys/bus/soundwire/devices/sdw:.../dp0/simple_ch_prep_sm
What	/sys/bus/soundwire/devices/sdw:.../dp0/imp_def_interrupts
Date	2020년 5월
Contact	Pierre-Louis Bossart <[email protected]>, Bard Liao <[email protected]>, Vinod Koul <[email protected]>
Description	SoundWire Slave Data Port 0의 DisCo 속성입니다. MIPI DisCo Specification for SoundWire가 정의하며 Data Port 0의 여러 속성을 나타내고 bus가 Data Port 0을 구성할 때 사용합니다.

SoundWire Slave Source·Sink Data Port N 속성

67-109

항목	한국어 전문 번역
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_word
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/min_word
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/words
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/type
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_grouping
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/simple_ch_prep_sm
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/ch_prep_timeout
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/imp_def_interrupts
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/min_ch
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_ch
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/channels
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/ch_combinations
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/max_async_buffer
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/block_pack_mode
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_src/port_encoding
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_word
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/min_word
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/words
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/type
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_grouping
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/simple_ch_prep_sm
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/ch_prep_timeout
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/imp_def_interrupts
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/min_ch
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_ch
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/channels
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/ch_combinations
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/max_async_buffer
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/block_pack_mode
What	/sys/bus/soundwire/devices/sdw:.../dp<N>_sink/port_encoding
Date	2020년 5월
Contact	Pierre-Louis Bossart <[email protected]>, Bard Liao <[email protected]>, Vinod Koul <[email protected]>
Description	SoundWire Slave의 Source·Sink Data Port N DisCo 속성입니다. MIPI DisCo Specification for SoundWire가 정의하며 Source·Sink Data Port N의 여러 속성을 나타내고 bus가 Data Port N을 구성할 때 사용합니다.