요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/spi/ti,qspi.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: TI QSPI controller
maintainers:
- Kousik Sanagavarapu <five231003@gmail.com>
allOf:
- $ref: spi-controller.yaml#
properties:
compatible:
enum:
- ti,am4372-qspi
- ti,dra7xxx-qspi
reg:
items:
- description: base registers
- description: mapped memory
reg-names:
items:
- const: qspi_base
- const: qspi_mmap
clocks:
maxItems: 1
clock-names:
items:
- const: fck
interrupts:
maxItems: 1
num-cs:
minimum: 1
maximum: 4
default: 1
ti,hwmods:
description:
Name of the hwmod associated to the QSPI. This is for legacy
platforms only.
$ref: /schemas/types.yaml#/definitions/string
deprecated: true
syscon-chipselects:
description:
Handle to system control region containing QSPI chipselect register
and offset of that register.
$ref: /schemas/types.yaml#/definitions/phandle-array
items:
- items:
- description: phandle to system control register
- description: register offset
spi-max-frequency:
description: Maximum SPI clocking speed of the controller in Hz.
$ref: /schemas/types.yaml#/definitions/uint32
required:
- compatible
- reg
- reg-names
- clocks
- clock-names
- interrupts
unevaluatedProperties: false
examples:
- |
#include <dt-bindings/clock/dra7.h>
#include <dt-bindings/interrupt-controller/arm-gic.h>
spi@4b300000 {
compatible = "ti,dra7xxx-qspi";
reg = <0x4b300000 0x100>,
<0x5c000000 0x4000000>;
reg-names = "qspi_base", "qspi_mmap";
syscon-chipselects = <&scm_conf 0x558>;
#address-cells = <1>;
#size-cells = <0>;
clocks = <&l4per2_clkctrl DRA7_L4PER2_QSPI_CLKCTRL 25>;
clock-names = "fck";
num-cs = <4>;
spi-max-frequency = <48000000>;
interrupts = <GIC_SPI 343 IRQ_TYPE_LEVEL_HIGH>;
};
...
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
TI QSPI controller schema
1-14이 GPL-2.0-only 또는 BSD-2-Clause YAML schema는 TI QSPI controller를 정의합니다. Maintainer는 Kousik Sanagavarapu이며 공통 `spi-controller.yaml#`을 상속합니다.
Base register와 mapped memory
15-40Compatible은 `ti,am4372-qspi` 또는 `ti,dra7xxx-qspi`입니다. `reg`는 base register와 mapped memory 두 항목이고 `reg-names`는 같은 순서로 `qspi_base`, `qspi_mmap`입니다.
`clocks`와 `interrupts`는 각각 최대 한 항목이고 `clock-names`는 `fck`입니다.
Chip select, legacy hwmod와 syscon
41-66`num-cs`는 사용하는 chip select 수로 1~4를 허용하며 기본값은 1입니다. Deprecated `ti,hwmods`는 legacy platform에서 QSPI와 연결된 hwmod 이름을 지정하는 string입니다.
`syscon-chipselects`는 QSPI chip-select register가 있는 system control region의 phandle과 그 register offset을 담는 phandle array입니다. `spi-max-frequency`는 controller의 최대 SPI clock 속도를 Hz 단위 `uint32`로 지정합니다.
필수 속성과 추가 속성 제한
67-76필수 속성은 `compatible`, `reg`, `reg-names`, `clocks`, `clock-names`, `interrupts`입니다. `unevaluatedProperties: false`로 평가되지 않은 추가 속성을 금지합니다.
DRA7 QSPI memory map 예제
77-96예제의 `spi@4b300000`은 `ti,dra7xxx-qspi`, 0x4b300000 base register와 0x5c000000 mapped memory를 사용합니다. `syscon-chipselects` offset은 0x558이고 functional clock `fck`, chip select 4개, 최대 48 MHz, GIC SPI 343을 지정합니다.
#include <dt-bindings/clock/dra7.h>
#include <dt-bindings/interrupt-controller/arm-gic.h>
spi@4b300000 {
compatible = "ti,dra7xxx-qspi";
reg = <0x4b300000 0x100>,
<0x5c000000 0x4000000>;
reg-names = "qspi_base", "qspi_mmap";
syscon-chipselects = <&scm_conf 0x558>;
#address-cells = <1>;
#size-cells = <0>;
clocks = <&l4per2_clkctrl DRA7_L4PER2_QSPI_CLKCTRL 25>;
clock-names = "fck";
num-cs = <4>;
spi-max-frequency = <48000000>;
interrupts = <GIC_SPI 343 IRQ_TYPE_LEVEL_HIGH>;
};
...
요약과 해설
ti,qspi.yaml:1-96TI QSPI의 base·mapped memory, chip-select syscon과 최대 clock을 설명합니다. 접을 수 있는 영어 원문 전체와 줄 좌표를 보존하고, 한국어 전문 번역에서는 compatible·property·symbol·source path·수치·예제 코드를 원형대로 유지합니다.