今日重点:🏷️ 术语卡——今天 radar 的 media 板块来了个完整系列: [PATCH v3 0/7] media: qcom: camss: Add SM8150 CAMSS support, 把骁龙 855 的相机子系统搬进主线。cover letter 一句话把全家点名: four CSIPHY, four CSID (two full and two lite), two VFE and two VFE-Lite。 四个缩写正好占满相机数据通路的四层:物理层 → 解码 → 前端处理 → 子系统容器。 按数据流串起来记:sensor 出信号,谁收、谁拆、谁处理、谁统管。 定义逐字取自系列各补丁与设备树 binding,发出于北京时间 11-07 凌晨,目前 v3 在评审中。

📖 原文(真实定义,逐字引用)

/ section
SM8150 contains four CSIPHY, four CSID (two full and two lite), two VFE and two VFE-Lite instances. The blocks are close to the existing SDM845/SM8250/SC8280XP implementations, so the driver change only adds platform data and hooks the SoC into the existing Gen2 CSID and VFE 17x code paths.
The CAMSS IP is a CSI decoder and ISP present on Qualcomm platforms.
Qualcomm MIPI CSI2 D-PHY. Connects MIPI CSI2 sensors to Qualcomm's Camera CSI decoder (CAMSS).

出处:Andrew Gigena 的 SM8150 CAMSS v3 系列(7 个补丁,北京时间 11-07 凌晨发出)。 第一句来自系列头封,第二句是 qcom,sm8150-camss.yaml 的 binding 描述, 第三句是 qcom,sm8150-csi2-phy.yaml 的 binding 描述—— 设备树 binding 的 description 就是内核里最权威的术语定义来源之一,写进文档的每句都过了评审。 顺带一处用词:作者写 hooks the SoC into the existing ... code paths—— hook into(挂进既有代码路径)是驱动移植的标准动词,比 "integrate" 轻、比 "add" 准。

🏷️ 术语一:CSIPHY / CSI-2 D-PHY —— 物理层

/ column

★ CSIPHY / CSI-2 D-PHY(CSI-2 物理层)

sensor 差分信号进来、数字数据流出去的那一级

原文定义 Document the Qualcomm SM8150 MIPI CSI2 D-PHY. The PHY sits between the CSI2 sensor and the CAMSS CSI decoder and is fed by the CSIPHY "core" and "timer" clocks, the TITAN top power domain and the vdda-phy/vdda-pll supplies.(3/7 设备树 binding 补丁)
中文与角色 PHY = physical layer(物理层)。MIPI CSI-2 链路上,sensor 出来的是 差分信号,CSIPHY 负责把它接收、转换成数字数据流——位置被原文点死: sits between the CSI2 sensor and the CAMSS CSI decoder。 它不管协议内容,只管把线上信号收下来。原文把依赖也列全了:core/timer 两个时钟、TITAN 顶部电源域、vdda-phy/vdda-pll 两路供电—— 硬件模块的「出生证明」就是这四样:时钟、电源域、供电、寄存器空间。
工程细节 SM8150 只有 D-PHY:Unlike the X1E80100 C-PHY/D-PHY combo PHY, SM8150 only has a D-PHY。新驱动暂不支持 DPHY split mode,所以 Pixel 4 上 共享 CSIPHY1 的副摄 OV7251 在本系列里被禁用,split-mode 支持留给后续补丁集。
记忆钩子 看到 PHY 先想模拟与 lane:差分对、时钟 lane、供电——它离协议最远、离引脚最近。

🏷️ 术语二:CSID —— 解码器

/ column

★ CSID(CSI 解码器)

按 CSI-2 协议拆包:虚拟通道、数据类型,全在这一级分拣

原文定义 SM8150 contains four CSIPHY, four CSID (two full and two lite) ... hooks the SoC into the existing Gen2 CSID and VFE 17x code paths. (系列头封)/ The CAMSS IP is a CSI decoder and ISP.(CAMSS binding)
中文与角色 CSIPHY 交出的是 lane 上的串行数据,CSID 按 CSI-2 协议拆包——解虚拟通道(VC)、 认数据类型(DT),分拣后交给后端。CAMSS binding 说自己 "is a CSI decoder and ISP", 那个 decoder 的硬件实例就是 CSID。full 与 lite 之分:完整版功能全, lite 版精简,高通把 lite 留给次要摄头——这个命名习惯在高通 IP 里反复出现。
本系列的相关动作 v3 的重头戏正是 PHY 与 decoder 分家:CSIPHY 的 I/O 空间、时钟、中断、 供电从 CAMSS 容器设备里挪出去,交给独立的 PHY 驱动—— the CSIPHY I/O spaces, clocks, interrupts and supplies are excluded from the CAMSS container device,此后 CAMSS keeps only VFE/CSID resources (19 clocks, 8 IRQs)。PHY 归 PHY 框架、decoder 归 media,各归其位。
记忆钩子 PHY 收信号、decoder 懂协议:CSID 是链路上第一个「看得懂包内容」的模块。

🏷️ 术语三:VFE / VFE-Lite —— 图像前端

/ column

★ VFE / VFE-Lite(图像前端)

把解码后的 RAW 数据做成可用帧的处理单元

原文定义 On SoCs where the lite VFEs come after the full VFEs, the generated name is vfe_lite2, vfe_lite3, ... and never matches the actual vfe_lite0/vfe_lite1 clocks, so their rates are never programmed. (4/7 时钟匹配修复补丁)
中文与角色 VFE 是 CSID 之后的图像前端处理单元,把解码后的 RAW 数据做成可用的帧。 高通时钟树里它叫 IFE——本系列 binding 的电源域描述写 IFE0 GDSC - Image Front End,修复补丁里的时钟名 cam_cc_ife_lite_0_clk 用的也是这个内部叫法。 读高通相机代码时 VFE 与 IFE 是同一件事的两个名字。
这个补丁修的 bug vfe->id 是 VFE 在资源数组里的下标。full VFE 排在 lite 前面时, 按 id 拼出的 lite 时钟名变成 vfe_lite2/vfe_lite3,永远匹配不上真实的 vfe_lite0/vfe_lite1——时钟停在 19.2 MHz,流起不来,报 "VFE reset timeout"。修法:前缀匹配限定带数字的 vfe_liteN(digit check), 避免误配 aux 时钟。影响 SM8150、SC7280、SC8280XP 三个 SoC。
记忆钩子 数组下标 ≠ 硬件实例号——用错就是「名字对不上,时钟永远不编程」, 最安静的 bug 都长这样。

🏷️ 术语四:CAMSS —— 子系统容器

/ column

★ CAMSS(相机子系统)

Camera Subsystem:把 PHY/CSID/VFE 连同时钟、中断、电源打包管理的容器

原文定义 Document the Qualcomm SM8150 Camera Subsystem. The IP integrates four CSIPHY, four CSID (two full and two lite), two VFE and two VFE-Lite instances, with 19 clocks, 8 interrupts, eight IOMMU streams, four interconnect paths and three power domains.(2/7 CAMSS binding 补丁)
中文与角色 CAMSS = Camera Subsystem(原文 "the Qualcomm SM8150 Camera Subsystem"),高通 SoC 里整个相机通路的总称。它是容器设备: 把 PHY/CSID/VFE 连同 19 个时钟、8 个中断、8 条 IOMMU 流、 4 条互连路径、3 个电源域打包描述与管理。读高通相机代码先找 CAMSS—— 它是入口,其余都是容器里的件。
系列定位 The series is intentionally SoC-level only: it does not add a board DTS, camera sensor drivers, or board-specific camera wiring. intentionally(刻意如此)提前堵评审的嘴——只把 SoC 级能力搬进主线, 板级接线与 sensor 驱动明确不管。作者在 Pixel 4 上实测后主摄、长焦、前摄、 IR 四路出流,但板级移植本身不进这个系列。
记忆钩子 子系统 = 模块 + 资源清单。看 binding 里 clock/interrupt/power-domain 的条目数,就能看出这个 IP 在 SoC 里的分量。

把四张卡连成一条链:sensor 出差分信号,CSIPHY(物理层)收成数字流, CSID(解码器)按 CSI-2 协议拆包,VFE(前端)把数据做成帧, CAMSS(子系统)把这四样连同时钟、中断、电源一起统管。 下次再读高通相机补丁,标题里的每个缩写都能立刻定位到链路上的位置。

✨ 辅助彩蛋:feeds / is fed by

/ section

★ 一句话交代数据去向与上游来源

硬件链路写作的方向动词对

原句 Each PHY node feeds one CAMSS CSI input port and is fed by the core and timer clocks, the vdda-phy and vdda-pll supplies, and the Titan top power domain.
中文与用法 feed = 给……输送(数据/时钟/供电)。主动 feeds 说下游去向 (PHY 喂给 CAMSS 的 CSI 输入口),被动 is fed by 说上游来源 (被时钟、供电、电源域喂着)。一对动词,把数据流和依赖流两个方向一句话说尽—— 硬件描述里比 "connects to" 信息量高得多。
仿写示范 The deserializer feeds the SoC's CSI input port and is fed by the sensor's pixel clock and the board's regulator tree.(仿写示范)

✍️ 今日练习

/ column
✍️ 两题。① 用英文回答:v3 为什么把 CSIPHY 的时钟、中断、供电移出 CAMSS 容器设备?移出之后 CAMSS 还剩什么资源(用原文数字作答)?② 把 CSIPHY / CSID / VFE / CAMSS 按数据从 sensor 出发经过的顺序排列,并各用一句中文说出它的角色。
💡 显示答案
参考作答:① As requested in the v2 review, the CSIPHY I/O spaces, clocks, interrupts and supplies are excluded from the CAMSS container device and instead described by four qcom,sm8150-csi2-phy nodes driven by the dedicated CSI2 PHY driver. CAMSS keeps only VFE/CSID resources — 19 clocks and 8 IRQs. ② CSIPHY → CSID → VFE → CAMSS。CSIPHY:MIPI CSI-2 物理层,把 sensor 的差分信号收成数字流;CSID:CSI 解码器,按协议拆包、分拣虚拟通道与数据类型;VFE:图像前端,把解码后的数据做成帧;CAMSS:相机子系统容器,统管以上模块及其时钟、中断、电源。(角色描述依据原文,组织方式为参考作答)
📖 原文:SM8150 contains four CSIPHY, four CSID (two full and two lite), two VFE and two VFE-Lite instances. / As requested in the v2 review, the CSIPHY I/O spaces, clocks, interrupts and supplies are excluded from the CAMSS container device and instead described by four qcom,sm8150-csi2-phy nodes driven by the dedicated CSI2 PHY driver. Each PHY node feeds one CAMSS CSI input port and is fed by the core and timer clocks, the vdda-phy and vdda-pll supplies, and the Titan top power domain. / CAMSS keeps only VFE/CSID resources (19 clocks, 8 IRQs).
📎 原文引用

每日一句:Between the sensor and the frame, every block has one job — the PHY receives, the decoder parses, the front end processes, and the subsystem keeps them all alive.

仿写示范