Uploaded QE firmware | Linux 6.18.37

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

1. 요약·해설

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

firmware.txt:1-24

CPM/QE 내부 자원과 자식 장치의 연결 규칙을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

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

원문 전체 펼치기

1 * Uploaded QE firmware

3 If a new firmware has been uploaded to the QE (usually by the

4 boot loader), then a 'firmware' child node should be added to the QE

5 node. This node provides information on the uploaded firmware that

6 device drivers may need.

8 Required properties:

9 - id: The string name of the firmware. This is taken from the 'id'

10 member of the qe_firmware structure of the uploaded firmware.

11 Device drivers can search this string to determine if the

12 firmware they want is already present.

13 - extended-modes: The Extended Modes bitfield, taken from the

14 firmware binary. It is a 64-bit number represented

15 as an array of two 32-bit numbers.

16 - virtual-traps: The virtual traps, taken from the firmware binary.

17 It is an array of 8 32-bit numbers.

19 Example:

20 firmware {

21 id = "Soft-UART";

22 extended-modes = <0 0>;

23 virtual-traps = <0 0 0 0 0 0 0 0>;

24 };

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

1-6

보통 boot loader가 QE에 새 firmware를 업로드했다면 QE 노드에 `firmware` 자식 노드를 추가해야 합니다. 이 노드는 device driver가 필요로 할 수 있는 업로드 firmware 정보를 제공합니다.

7-17

`id`는 업로드된 firmware의 `qe_firmware` 구조체 `id` member에서 가져온 문자열 이름입니다. 드라이버는 이 문자열을 검색해 원하는 firmware가 이미 있는지 판단할 수 있습니다.

`extended-modes`는 firmware binary에서 가져온 Extended Modes bitfield이며 32비트 숫자 두 개 배열로 표현한 64비트 값입니다.

`virtual-traps`는 firmware binary에서 가져온 virtual trap이며 32비트 숫자 8개 배열입니다.

18-24

예제는 `Soft-UART` firmware, 0인 extended modes와 8개 모두 0인 virtual trap을 선언합니다.

firmware {
        id = "Soft-UART";
        extended-modes = <0 0>;
        virtual-traps = <0 0 0 0 0 0 0 0>;
};