Cirrus CLPS711X Framebuffer | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

cirrus,clps711x-fb.txt:1-47

별도 framebuffer memory와 320x240 display timing 예제를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 * Cirrus Logic CLPS711X Framebuffer

3 Required properties:

4 - compatible: Shall contain "cirrus,ep7209-fb".

5 - reg : Physical base address and length of the controller's registers +

6 location and size of the framebuffer memory.

7 - clocks : phandle + clock specifier pair of the FB reference clock.

8 - display : phandle to a display node as described in

9 Documentation/devicetree/bindings/display/panel/display-timing.txt.

10 Additionally, the display node has to define properties:

11 - bits-per-pixel: Bits per pixel.

12 - ac-prescale : LCD AC bias frequency. This frequency is the required

13 AC bias frequency for a given manufacturer's LCD plate.

14 - cmap-invert : Invert the color levels (Optional).

16 Optional properties:

17 - lcd-supply: Regulator for LCD supply voltage.

19 Example:

20 fb: fb@800002c0 {

21 compatible = "cirrus,ep7312-fb", "cirrus,ep7209-fb";

22 reg = <0x800002c0 0xd44>, <0x60000000 0xc000>;

23 clocks = <&clks 2>;

24 lcd-supply = <&reg5v0>;

25 display = <&display>;

26 };

28 display: display {

29 model = "320x240x4";

30 bits-per-pixel = <4>;

31 ac-prescale = <17>;

33 display-timings {

34 native-mode = <&timing0>;

35 timing0: 320x240 {

36 hactive = <320>;

37 hback-porch = <0>;

38 hfront-porch = <0>;

39 hsync-len = <0>;

40 vactive = <240>;

41 vback-porch = <0>;

42 vfront-porch = <0>;

43 vsync-len = <0>;

44 clock-frequency = <6500000>;

45 };

46 };

47 };

3. 한국어 전문 번역

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

CLPS711X framebuffer 속성

1-18

Cirrus Logic CLPS711X framebuffer 바인딩입니다. `compatible`에는 `cirrus,ep7209-fb`가 들어가야 합니다. `reg`는 controller register의 physical base address와 length뿐 아니라 framebuffer memory의 위치와 크기도 함께 담습니다. `clocks`는 framebuffer reference clock의 phandle과 clock specifier 쌍입니다.

`display`는 `Documentation/devicetree/bindings/display/panel/display-timing.txt`에 정의된 display node를 가리키는 phandle입니다. 이 display node에는 pixel당 bit 수를 나타내는 `bits-per-pixel`과 해당 제조사 LCD plate에 필요한 LCD AC bias frequency인 `ac-prescale`을 추가로 지정해야 합니다. 선택 속성 `cmap-invert`는 color level을 반전합니다.

선택 속성 `lcd-supply`는 LCD supply voltage를 제공하는 regulator를 가리킵니다.

CLPS711X framebuffer 구성

reg[0]Controller registers

reg[1]Framebuffer memory

CLPS711X FB + reference clockPixel data

display nodebpp, AC bias, timing

LCD panelOptional lcd-supply

Controller register와 별도 framebuffer memory를 display timing 및 LCD 전원에 결합합니다.

320x240 4-bpp timing 예제

19-47

예제 framebuffer node는 EP7312 호환성과 기본 EP7209 호환성을 함께 선언하고, controller register와 `0x60000000`의 framebuffer memory를 두 `reg` 범위로 제공합니다. Clock index 2와 5 V regulator를 사용하고 `display` node를 참조합니다.

Display는 `320x240x4` 모델, pixel당 4 bit, AC prescale 17을 사용합니다. `timing0`이 native mode이며 active 영역은 320x240, 모든 porch와 sync length는 0, pixel clock은 6,500,000 Hz입니다.

fb: fb@800002c0 {
        compatible = "cirrus,ep7312-fb", "cirrus,ep7209-fb";
        reg = <0x800002c0 0xd44>, <0x60000000 0xc000>;
        clocks = <&clks 2>;
        lcd-supply = <&reg5v0>;
        display = <&display>;
};

display: display {
        model = "320x240x4";
        bits-per-pixel = <4>;
        ac-prescale = <17>;

        display-timings {
                native-mode = <&timing0>;
                timing0: 320x240 {
                        hactive = <320>;
                        hback-porch = <0>;
                        hfront-porch = <0>;
                        hsync-len = <0>;
                        vactive = <240>;
                        vback-porch = <0>;
                        vfront-porch = <0>;
                        vsync-len = <0>;
                        clock-frequency = <6500000>;
                };
        };
};