요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Qualcomm Hexagon Peripheral Image Loader
This document defines the binding for a component that loads and boots firmware
on the Qualcomm Hexagon core.
- compatible:
Usage: required
Value type: <string>
Definition: must be one of:
"qcom,ipq8074-wcss-pil"
"qcom,qcs404-wcss-pil"
- reg:
Usage: required
Value type: <prop-encoded-array>
Definition: must specify the base address and size of the qdsp6 and
rmb register blocks
- reg-names:
Usage: required
Value type: <stringlist>
Definition: must be "q6dsp" and "rmb"
- interrupts-extended:
Usage: required
Value type: <prop-encoded-array>
Definition: reference to the interrupts that match interrupt-names
- interrupt-names:
Usage: required
Value type: <stringlist>
Definition: must be "wdog", "fatal", "ready", "handover", "stop-ack"
- clocks:
Usage: required
Value type: <phandle>
Definition: reference to the clocks that match clock-names
- clock-names:
Usage: required
Value type: <stringlist>
Definition: The clocks needed depend on the compatible string:
qcom,ipq8074-wcss-pil:
no clock names required
qcom,qcs404-wcss-pil:
must be "xo", "gcc_abhs_cbcr", "gcc_abhs_cbcr",
"gcc_axim_cbcr", "lcc_ahbfabric_cbc", "tcsr_lcc_cbc",
"lcc_abhs_cbc", "lcc_tcm_slave_cbc", "lcc_abhm_cbc",
"lcc_axim_cbc", "lcc_bcr_sleep"
- resets:
Usage: required
Value type: <phandle>
Definition: reference to the list of 3 reset-controllers for the
wcss sub-system
- reset-names:
Usage: required
Value type: <stringlist>
Definition: must be "wcss_aon_reset", "wcss_reset", "wcss_q6_reset"
for the wcss sub-system
- memory-region:
Usage: required
Value type: <phandle>
Definition: reference to wcss reserved-memory region.
For the compatible string below the following supplies are required:
"qcom,qcs404-wcss-pil"
- cx-supply:
Usage: required
Value type: <phandle>
Definition: reference to the regulators to be held on behalf of the
booting of the Hexagon core
- qcom,smem-states:
Usage: required
Value type: <phandle>
Definition: reference to the smem state for requesting the Hexagon to
shut down
- qcom,smem-state-names:
Usage: required
Value type: <stringlist>
Definition: must be "stop"
- qcom,halt-regs:
Usage: required
Value type: <prop-encoded-array>
Definition: a phandle reference to a syscon representing TCSR followed
by the three offsets within syscon for q6, wcss and nc
halt registers.
- memory-region:
Usage: required
Value type: <phandle>
Definition: reference to the reserved-memory for the region
The Hexagon node may also have an subnode named either "smd-edge" or
"glink-edge" that describes the communication edge, channels and devices
related to the Hexagon. See ../soc/qcom/qcom,smd.yaml and
../soc/qcom/qcom,glink.txt for details on how to describe these.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Qualcomm Hexagon PIL
1-5이 문서는 Qualcomm Hexagon core에 firmware를 load하고 boot하는 component의 binding을 정의합니다.
Compatible과 register block
6-23필수 string `compatible`은 `qcom,ipq8074-wcss-pil` 또는 `qcom,qcs404-wcss-pil`이어야 합니다. 필수 prop-encoded array `reg`에는 `qdsp6`와 `rmb` register block의 base address와 size를 지정합니다. 필수 stringlist `reg-names`는 `q6dsp`, `rmb`여야 합니다.
Interrupt와 compatible별 clock
24-50필수 `interrupts-extended`는 `interrupt-names`에 대응하는 interrupt reference입니다. `interrupt-names` stringlist는 `wdog`, `fatal`, `ready`, `handover`, `stop-ack`여야 합니다.
필수 `clocks`는 `clock-names`에 대응하는 clock reference입니다. `qcom,ipq8074-wcss-pil`에는 clock 이름이 필요하지 않습니다.
`qcom,qcs404-wcss-pil`에는 `xo`, `gcc_abhs_cbcr`, `gcc_abhs_cbcr`, `gcc_axim_cbcr`, `lcc_ahbfabric_cbc`, `tcsr_lcc_cbc`, `lcc_abhs_cbc`, `lcc_tcm_slave_cbc`, `lcc_abhm_cbc`, `lcc_axim_cbc`, `lcc_bcr_sleep`가 필요합니다. 원문은 `gcc_abhs_cbcr`를 두 번 나열합니다.
Reset controller와 reserved memory
51-67필수 `resets` phandle은 WCSS subsystem의 reset-controller 3개 목록을 참조합니다. `reset-names` stringlist는 `wcss_aon_reset`, `wcss_reset`, `wcss_q6_reset`이어야 합니다.
필수 `memory-region` phandle은 WCSS reserved-memory region을 참조합니다.
QCS404 CX supply
68-75`qcom,qcs404-wcss-pil` compatible에서는 필수 `cx-supply` phandle이 필요합니다. 이는 Hexagon core boot를 대신해 켜진 상태로 유지할 regulator를 참조합니다.
SMEM shutdown과 halt register
76-98필수 `qcom,smem-states` phandle은 Hexagon shutdown 요청에 사용할 SMEM state를 참조하고, 필수 `qcom,smem-state-names` stringlist는 `stop`이어야 합니다.
필수 `qcom,halt-regs` prop-encoded array는 TCSR을 나타내는 syscon phandle 뒤에 q6, wcss, nc halt register의 syscon 내부 offset 3개를 둡니다.
문서에 다시 등장하는 필수 `memory-region` phandle은 해당 region의 reserved-memory를 참조합니다.
SMD 또는 GLINK communication edge
99-102Hexagon node에는 `smd-edge` 또는 `glink-edge` subnode를 둘 수 있으며, Hexagon 관련 communication edge, channel, device를 기술합니다. 작성 방법은 `../soc/qcom/qcom,smd.yaml`과 `../soc/qcom/qcom,glink.txt`를 참조하십시오.
요약과 해설
qcom,q6v5.txt:1-102필수 property와 원문 특이점을 요약하고 영어 원문 전체 및 줄 좌표별 한국어 전문을 제공합니다.