← Documents Documentation/ABI/testing/sysfs-devices-platform-stratix10-rsu GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Intel Stratix10 Remote System Update sysfs ABI

Stratix10 RSU의 current/failed image, state·firmware error fields, retry와 reboot image, notify actions, DCMF copies 및 max-retry storage를 설명합니다.

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

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

1. 요약·해설

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

Image status, error fields and retry

sysfs-devices-platform-stratix10-rsu:1-94

RSU status attributes는 running/failed image 주소, major·minor error, reporting firmware, error offset/code와 fail-over 전 남은 retry를 제공합니다.

Firmware notification actions

sysfs-devices-platform-stratix10-rsu:95-139

notify write는 software execution stage를 전달하고 image retry reset·RSU log clear·notify-code recording을 bit별로 제어합니다.

Decision-firmware copies and retry limit

sysfs-devices-platform-stratix10-rsu:140-174

dcmf0-3는 네 Decision firmware copy의 version을, max_retry는 firmware decision IO section offset 0x18c의 retry limit byte를 expose합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 Intel Stratix10 Remote System Update (RSU) device attributes
2
3 What: /sys/devices/platform/stratix10-rsu.0/current_image
4 Date: August 2019
5 KernelVersion: 5.4
6 Contact: Richard Gong <richard.gong@linux.intel.com>
7 Description:
8 (RO) the address in flash of currently running image.
9
10 What: /sys/devices/platform/stratix10-rsu.0/fail_image
11 Date: August 2019
12 KernelVersion: 5.4
13 Contact: Richard Gong <richard.gong@linux.intel.com>
14 Description:
15 (RO) the address in flash of failed image.
16
17 What: /sys/devices/platform/stratix10-rsu.0/state
18 Date: August 2019
19 KernelVersion: 5.4
20 Contact: Richard Gong <richard.gong@linux.intel.com>
21 Description:
22 (RO) the state of RSU system.
23 The state field has two parts: major error code in
24 upper 16 bits and minor error code in lower 16 bits.
25
26 b[15:0]
27 Currently used only when major error is 0xF006
28 (CPU watchdog timeout), in which case the minor
29 error code is the value reported by CPU to
30 firmware through the RSU notify command before
31 the watchdog timeout occurs.
32
33 b[31:16]
34 0xF001 bitstream error
35 0xF002 hardware access failure
36 0xF003 bitstream corruption
37 0xF004 internal error
38 0xF005 device error
39 0xF006 CPU watchdog timeout
40 0xF007 internal unknown error
41
42 What: /sys/devices/platform/stratix10-rsu.0/version
43 Date: August 2019
44 KernelVersion: 5.4
45 Contact: Richard Gong <richard.gong@linux.intel.com>
46 Description:
47 (RO) the version number of RSU firmware. 19.3 or late
48 version includes information about the firmware which
49 reported the error.
50
51 pre 19.3:
52 b[31:0]
53 0x0 version number
54
55 19.3 or late:
56 b[15:0]
57 0x1 version number
58 b[31:16]
59 0x0 no error
60 0x0DCF Decision CMF error
61 0x0ACF Application CMF error
62
63 What: /sys/devices/platform/stratix10-rsu.0/error_location
64 Date: August 2019
65 KernelVersion: 5.4
66 Contact: Richard Gong <richard.gong@linux.intel.com>
67 Description:
68 (RO) the error offset inside the image that failed.
69
70 What: /sys/devices/platform/stratix10-rsu.0/error_details
71 Date: August 2019
72 KernelVersion: 5.4
73 Contact: Richard Gong <richard.gong@linux.intel.com>
74 Description:
75 (RO) error code.
76
77 What: /sys/devices/platform/stratix10-rsu.0/retry_counter
78 Date: August 2019
79 KernelVersion: 5.4
80 Contact: Richard Gong <richard.gong@linux.intel.com>
81 Description:
82 (RO) the current image's retry counter, which is used by
83 user to know how many times the images is still allowed
84 to reload itself before giving up and starting RSU
85 fail-over flow.
86
87 What: /sys/devices/platform/stratix10-rsu.0/reboot_image
88 Date: August 2019
89 KernelVersion: 5.4
90 Contact: Richard Gong <richard.gong@linux.intel.com>
91 Description:
92 (WO) the address in flash of image to be loaded on next
93 reboot command.
94
95 What: /sys/devices/platform/stratix10-rsu.0/notify
96 Date: August 2019
97 KernelVersion: 5.4
98 Contact: Richard Gong <richard.gong@linux.intel.com>
99 Description:
100 (WO) client to notify firmware with different actions.
101
102 b[15:0]
103 inform firmware the current software execution
104 stage.
105
106 == ===========================================
107 0 the first stage bootloader didn't run or
108 didn't reach the point of launching second
109 stage bootloader.
110 1 failed in second bootloader or didn't get
111 to the point of launching the operating
112 system.
113 2 both first and second stage bootloader ran
114 and the operating system launch was
115 attempted.
116 == ===========================================
117
118 b[16]
119 == ===========================================
120 1 firmware to reset current image retry
121 counter.
122 0 no action.
123 == ===========================================
124
125 b[17]
126 == ===========================================
127 1 firmware to clear RSU log
128 0 no action.
129 == ===========================================
130
131 b[18]
132 this is negative logic
133
134 == ===========================================
135 1 no action
136 0 firmware record the notify code defined
137 in b[15:0].
138 == ===========================================
139
140 What: /sys/devices/platform/stratix10-rsu.0/dcmf0
141 Date: June 2020
142 KernelVersion: 5.8
143 Contact: Richard Gong <richard.gong@linux.intel.com>
144 Description:
145 (RO) Decision firmware copy 0 version information.
146
147 What: /sys/devices/platform/stratix10-rsu.0/dcmf1
148 Date: June 2020
149 KernelVersion: 5.8
150 Contact: Richard Gong <richard.gong@linux.intel.com>
151 Description:
152 (RO) Decision firmware copy 1 version information.
153
154 What: /sys/devices/platform/stratix10-rsu.0/dcmf2
155 Date: June 2020
156 KernelVersion: 5.8
157 Contact: Richard Gong <richard.gong@linux.intel.com>
158 Description:
159 (RO) Decision firmware copy 2 version information.
160
161 What: /sys/devices/platform/stratix10-rsu.0/dcmf3
162 Date: June 2020
163 KernelVersion: 5.8
164 Contact: Richard Gong <richard.gong@linux.intel.com>
165 Description:
166 (RO) Decision firmware copy 3 version information.
167
168 What: /sys/devices/platform/stratix10-rsu.0/max_retry
169 Date: June 2020
170 KernelVersion: 5.8
171 Contact: Richard Gong <richard.gong@linux.intel.com>
172 Description:
173 (RO) max retry parameter is stored in the firmware
174 decision IO section, as a byte located at offset 0x18c.
175

3. 한국어 전문 번역

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

Currently running RSU image

1-9
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/current_image
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
DescriptionIntel Stratix10 Remote System Update(RSU) device attribute입니다. (RO) 현재 실행 중인 image의 flash address입니다.

Failed RSU image

10-16
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/fail_image
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) 실패한 image의 flash address입니다.
RSU image selection and fail-over context
current_image 실행Failure이면 fail_image 기록retry_counter 감소Retry 소진 시 RSU fail-over flowreboot_image로 next image 지정 가능

Status와 retry information은 현재 image가 fail-over로 넘어가기 전 상태를 해석하는 데 쓰입니다.

RSU major and minor state codes

17-41
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/state
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) RSU system state입니다. State field는 upper 16 bits의 major error code와 lower 16 bits의 minor error code로 구성됩니다. b[15:0]은 major error가 0xF006(CPU watchdog timeout)일 때만 현재 사용됩니다. 이 경우 minor error code는 watchdog timeout이 발생하기 전에 CPU가 RSU notify command를 통해 firmware에 보고한 값입니다.
RSU state bit layout
Bits의미
b[31:16]Major error code
b[15:0]Minor code; major 0xF006에서만 사용

32-bit state의 major/minor field 배치입니다.

RSU major error codes
CodeMeaning
0xF001Bitstream error
0xF002Hardware access failure
0xF003Bitstream corruption
0xF004Internal error
0xF005Device error
0xF006CPU watchdog timeout
0xF007Internal unknown error

Upper 16-bit field에 정의된 major error 값입니다.

RSU firmware version and reporter

42-62
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/version
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) RSU firmware version number입니다. Version 19.3 이상은 error를 보고한 firmware 정보도 포함합니다. 19.3 이전에는 b[31:0]의 0x0이 version number입니다. 19.3 이상에서는 b[15:0]의 0x1이 version number이고 b[31:16]이 reporting/error source를 나타냅니다.
RSU firmware version layouts
FirmwareBitsValueMeaning
Pre-19.3b[31:0]0x0Version number
19.3 or laterb[15:0]0x1Version number
19.3 or laterb[31:16]0x0No error
19.3 or laterb[31:16]0x0DCFDecision CMF error
19.3 or laterb[31:16]0x0ACFApplication CMF error

Pre-19.3와 19.3 이상 field interpretation을 원문 값 그대로 정리했습니다.

Failed-image error offset

63-69
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/error_location
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) 실패한 image 내부의 error offset입니다.

RSU error detail code

70-76
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/error_details
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) Error code입니다.

Current-image retry counter

77-86
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/retry_counter
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) 현재 image의 retry counter입니다. User는 이 값을 통해 image가 포기하고 RSU fail-over flow를 시작하기 전까지 자체 reload가 몇 번 더 허용되는지 알 수 있습니다.

Image selected for next reboot

87-94
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/reboot_image
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
Description(WO) 다음 reboot command에서 load할 image의 flash address입니다.

RSU firmware notification command

95-139
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/notify
Date2019년 8월
KernelVersion5.4
ContactRichard Gong <richard.gong@linux.intel.com>
Description(WO) Client가 여러 action으로 firmware에 notify하는 값입니다. b[15:0]은 현재 software execution stage를 firmware에 알립니다. b[16]은 current-image retry counter reset, b[17]은 RSU log clear를 제어합니다. b[18]은 negative logic이며 notify code 기록 여부를 제어합니다.
RSU notify bit fields
BitsValueAction
b[15:0]0 / 1 / 2Current software execution stage
b[16]1Current-image retry counter reset
b[16]0No action
b[17]1RSU log clear
b[17]0No action
b[18]1No action
b[18]0Record b[15:0] notify code

각 field와 action의 polarity입니다.

RSU software execution stages
ValueExecution stage
0First-stage bootloader가 실행되지 않았거나 second-stage bootloader launch 지점에 도달하지 못함
1Second bootloader에서 실패했거나 operating-system launch 지점에 도달하지 못함
2First/second-stage bootloader가 모두 실행되었고 operating-system launch를 시도함

b[15:0] stage value의 전체 의미입니다.

Decision firmware copy 0

140-146
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/dcmf0
Date2020년 6월
KernelVersion5.8
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) Decision firmware copy 0의 version information입니다.
Decision firmware copy attributes
AttributeMeaning
dcmf0Decision firmware copy 0 version
dcmf1Decision firmware copy 1 version
dcmf2Decision firmware copy 2 version
dcmf3Decision firmware copy 3 version
max_retryDecision IO offset 0x18c의 retry-limit byte

네 copy의 version attribute와 retry-limit storage입니다.

Decision firmware copy 1

147-153
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/dcmf1
Date2020년 6월
KernelVersion5.8
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) Decision firmware copy 1의 version information입니다.

Decision firmware copy 2

154-160
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/dcmf2
Date2020년 6월
KernelVersion5.8
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) Decision firmware copy 2의 version information입니다.

Decision firmware copy 3

161-167
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/dcmf3
Date2020년 6월
KernelVersion5.8
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) Decision firmware copy 3의 version information입니다.

Firmware maximum retry parameter

168-174
항목한국어 전문 번역
What/sys/devices/platform/stratix10-rsu.0/max_retry
Date2020년 6월
KernelVersion5.8
ContactRichard Gong <richard.gong@linux.intel.com>
Description(RO) Max-retry parameter는 firmware decision IO section의 offset 0x18c에 있는 한 byte로 저장됩니다.