요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Reconfiguration error detail
sysfs-class-fpga-manager:38-60Operation·CRC·incompatible image·IP protocol·FIFO overflow 오류를 별도 status 문자열로 보고합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/class/fpga_manager/<fpga>/name
2
Date: August 2015
3
KernelVersion: 4.3
4
Contact: Alan Tull <[email protected]>
5
Description: Name of low level fpga manager driver.
7
What: /sys/class/fpga_manager/<fpga>/state
8
Date: August 2015
9
KernelVersion: 4.3
10
Contact: Alan Tull <[email protected]>
11
Description: Read fpga manager state as a string.
12
The intent is to provide enough detail that if something goes
13
wrong during FPGA programming (something that the driver can't
14
fix) then userspace can know, i.e. if the firmware request
15
fails, that could be due to not being able to find the firmware
16
file.
18
This is a superset of FPGA states and fpga manager driver
19
states. The fpga manager driver is walking through these steps
20
to get the FPGA into a known operating state. It's a sequence,
21
though some steps may get skipped. Valid FPGA states will vary
22
by manufacturer; this is a superset.
24
* unknown = can't determine state
25
* power off = FPGA power is off
26
* power up = FPGA reports power is up
27
* reset = FPGA held in reset state
28
* firmware request = firmware class request in progress
29
* firmware request error = firmware request failed
30
* write init = preparing FPGA for programming
31
* write init error = Error while preparing FPGA for programming
32
* write = FPGA ready to receive image data
33
* write error = Error while programming
34
* write complete = Doing post programming steps
35
* write complete error = Error while doing post programming
36
* operating = FPGA is programmed and operating
38
What: /sys/class/fpga_manager/<fpga>/status
39
Date: June 2018
40
KernelVersion: 4.19
41
Contact: Wu Hao <[email protected]>
42
Description: Read fpga manager status as a string.
43
If FPGA programming operation fails, it could be caused by crc
44
error or incompatible bitstream image. The intent of this
45
interface is to provide more detailed information for FPGA
46
programming errors to userspace. This is a list of strings for
47
the supported status.
49
* reconfig operation error - invalid operations detected by
50
reconfiguration hardware.
51
e.g. start reconfiguration
52
with errors not cleared
53
* reconfig CRC error - CRC error detected by
54
reconfiguration hardware.
55
* reconfig incompatible image - reconfiguration image is
56
incompatible with hardware
57
* reconfig IP protocol error - protocol errors detected by
58
reconfiguration hardware
59
* reconfig fifo overflow error - FIFO overflow detected by
60
reconfiguration hardware
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Low-level FPGA manager driver 이름
1-5| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/fpga_manager/<fpga>/name |
| Date | 2015년 8월 |
| KernelVersion | 4.3 |
| Contact | Alan Tull <[email protected]> |
| Description | Low-level FPGA manager driver의 이름입니다. |
FPGA programming 진행 상태
7-36| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/fpga_manager/<fpga>/state |
| Date | 2015년 8월 |
| KernelVersion | 4.3 |
| Contact | Alan Tull <[email protected]> |
| Description | FPGA manager 상태를 문자열로 읽습니다. Driver가 복구할 수 없는 FPGA programming 문제가 생겼을 때 userspace에 충분한 detail을 제공하려는 interface입니다. 예를 들어 firmware request 실패는 firmware file을 찾지 못해서 발생했을 수 있습니다. 이 목록은 FPGA state와 FPGA manager driver state의 superset입니다. Driver는 FPGA를 알려진 operating state로 만들기 위해 이 sequence를 진행하지만 일부 단계는 건너뛸 수 있습니다. 유효한 FPGA state는 manufacturer마다 다르므로 아래 목록은 superset입니다. |
State의미
unknown상태를 확인할 수 없음
power offFPGA power가 꺼짐
power upFPGA가 power up을 보고함
resetFPGA가 reset 상태로 유지됨
firmware requestFirmware class request 진행 중
firmware request errorFirmware request 실패
write initFPGA programming 준비 단계
write init errorFPGA programming 준비 단계의 오류
writeFPGA가 image data를 받을 준비가 됨
write errorProgramming 중 오류
write completeProgramming 후속 단계 수행 중
write complete errorProgramming 후속 단계 중 오류
operatingFPGA programming이 끝나 동작 중
Programming sequence의 정상 단계와 단계별 오류 상태입니다.
FPGA reconfiguration 상세 오류
38-60| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/fpga_manager/<fpga>/status |
| Date | 2018년 6월 |
| KernelVersion | 4.19 |
| Contact | Wu Hao <[email protected]> |
| Description | FPGA manager status를 문자열로 읽습니다. FPGA programming 작업은 CRC error나 호환되지 않는 bitstream image 때문에 실패할 수 있습니다. 이 interface는 FPGA programming error의 더 자세한 정보를 userspace에 제공하기 위한 것이며 지원 status 문자열은 아래와 같습니다. |
Status의미
reconfig operation errorReconfiguration hardware가 잘못된 operation 감지. 예: error를 clear하지 않고 reconfiguration 시작
reconfig CRC errorReconfiguration hardware가 CRC error 감지
reconfig incompatible imageReconfiguration image가 hardware와 호환되지 않음
reconfig IP protocol errorReconfiguration hardware가 protocol error 감지
reconfig fifo overflow errorReconfiguration hardware가 FIFO overflow 감지
Reconfiguration hardware가 감지하는 다섯 오류 범주입니다.
Driver identity and programming sequence
sysfs-class-fpga-manager:1-36Driver 이름과 power·reset·firmware request·write·operating 단계 및 단계별 programming error를 노출합니다.