요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/devices/pciXXXX:XX/0000:XX:XX.X/0000:XX:XX.X/version
2
Date: June 2024
3
KernelVersion: 6.11
4
Contact: Gerhard Engleder <[email protected]>
5
Description: Version of the FPGA configuration bitstream as printable string.
6
This file is read only.
7
Users: KEBA
9
What: /sys/devices/pciXXXX:XX/0000:XX:XX.X/0000:XX:XX.X/keep_cfg
10
Date: June 2024
11
KernelVersion: 6.11
12
Contact: Gerhard Engleder <[email protected]>
13
Description: Flag which signals if FPGA shall keep or reload configuration
14
bitstream on reset. Normal FPGA behavior and default is to keep
15
configuration bitstream and to only reset the configured logic.
17
Reloading configuration on reset enables an update of the
18
configuration bitstream with a simple reboot. Otherwise it is
19
necessary to power cycle the device to reload the new
20
configuration bitstream.
22
This file is read/write. The values are as follows:
23
1 = keep configuration bitstream on reset, default
24
0 = reload configuration bitstream on reset
25
Users: KEBA
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
FPGA configuration bitstream과 reset 동작
1-25두 ABI는 2024년 6월 kernel 6.11에 도입됐고 Gerhard Engleder <[email protected]>가 담당한다. 사용자는 KEBA다. 공통 경로는 /sys/devices/pciXXXX:XX/0000:XX:XX.X/0000:XX:XX.X/다.
| 경로 suffix | 접근 | 설명 |
|---|---|---|
| version | read-only | FPGA configuration bitstream의 version을 출력 가능한 문자열로 표시한다. |
| keep_cfg | read/write | FPGA가 reset 때 configuration bitstream을 유지할지 다시 load할지 정하는 flag다. |
일반적인 FPGA 동작이자 기본값은 configuration bitstream을 유지하고, 이미 구성된 logic만 reset하는 것이다.
Reset 때 configuration을 reload하도록 선택하면 간단한 reboot만으로 configuration bitstream update를 적용할 수 있다. 이 설정을 사용하지 않으면 새 configuration bitstream을 reload하기 위해 device 전원을 완전히 껐다 켜야 한다.
| keep_cfg | Reset 동작 |
|---|---|
| 1 | Configuration bitstream을 유지한다. 기본값이다. |
| 0 | Reset 때 configuration bitstream을 다시 load한다. |
새 configuration bitstream 준비→keep_cfg=1이면 reset 후 기존 configuration 유지→새 bitstream 적용에는 power cycle 필요→keep_cfg=0이면 다음 reset에서 configuration reload→Reboot만으로 새 bitstream 적용 가능
Reset이 configured logic만 초기화할지 FPGA configuration까지 다시 load할지 결정한다.
FPGA bitstream version과 reset policy
sysfs-driver-misc-cp500:1-25현재 FPGA configuration version을 읽고 reboot만으로 새 bitstream을 load할지 제어합니다.