요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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 <[email protected]>
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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·수치·예제 코드를 원형대로 유지합니다.