设备树文件说明

2025-08-21

1. ​PI-SG565D 的顶层设备树是 qcs6490-idp-pi.dts ，可以在 src/qcom-6.6-overlay/arch/arm64/boot/dts/qcom/ 和 sources/quectel-src/kernel/qcom-6.6/arch/arm64/boot/dts/qcom/ 目录下找到，对于设备树的所有修改，推荐在此文件上进行。

2. 除此之外，在开发过程中，sources/quectel-src/kernel/qcom-6.6/arch/arm64/boot/dts/qcom/sc7280.dtsi 也可能会高频查看。 sc7280.dtsi 中拥有 GPIO、SPI、I2C、UART、CPU、GPU 等开发过程中较为常用的节点。

3. 高通平台将显示、图形、摄像头、视频等相关的驱动和设备树从 linux kernel 源码中分离出来成独立的仓库，可根据 Yocto 构建指南 下载 Yocto 工程源码，通过查看 layers/meta-qcom-hwe 目录下的 .bb 文件提供的信息访问具体的代码仓库。

以查看摄像头的设备树为例，查看 layers/meta-qcom-hwe/recipes-multimedia/cameradtb/cameradtb_1.0.bb 文件，有如下内容：

SRCPROJECT = "git://git.codelinaro.org/clo/le/platform/vendor/opensource/camera-devicetree.git;protocol=https"
SRCBRANCH  = "camera-kernel.qclinux.1.0.r1-rel"
SRCREV     = "08511ff747916576232cc26394bb9c5c6e0ab1f5"



为了编译的设备树烧录到板子后，板子可正常运行，PI-SG565D 将这些独立 linux kernel 源码外的设备树子仓库，放到了 src/devicetree 目录下：

  • 摄像头：src/devicetree/camera-devicetree

  • 显示：src/devicetree/display-devicetree

  • 图形：src/devicetree/graphics-devicetree

  • 视频：src/devicetree/video-devicetree



设备树配方和路径

1. 顶层设备树

QuecPi-QCLinux-BL01/sources/quectel-src/kernel/qcom-6.6/arch/arm64/boot/dts/qcom/qcs6490-idp-pi.dts

还有个同名的，路径在内核代码外，为了方便修改覆盖：

QuecPi-QCLinux-BL01/src/qcom-6.6-overlay/arch/arm64/boot/dts/qcom/qcs6490-idp-pi.dts

  • 除此之外，在开发过程中，同级目录的 sc7280.dtsi 也可能会高频查看。 sc7280.dtsi 中拥有 GPIO、SPI、I2C、UART、CPU、GPU 等开发过程中较为常用的节点。

2. camera

  • camera 设备树

QuecPi-QCLinux-BL01/src/devicetree/camera-devicetree/qcm6490-camera-rb3.dtsi


QuecPi-QCLinux-BL01/src/devicetree/camera-devicetree/qcm6490-camera-sensor-rb3.dtsi

  • camera 设备树对应的 bb 文件

QuecPi-QCLinux-BL01/layers/meta-qcom-hwe/recipes-multimedia/cameradtb/cameradtb_1.0.bb


QuecPi-QCLinux-BL01/layers/meta-quectel/recipes-multimedia/cameradtb/cameradtb_1.0.bbappend

3. diaplay

  • display 设备树

QuecPi-QCLinux-BL01/src/devicetree/display-devicetree/display/dsi-panel-waveshare-8inch-video.dtsi


QuecPi-QCLinux-BL01/src/devicetree/display-devicetree/display/qcm6490-sde-display-pi.dtsi


QuecPi-QCLinux-BL01/src/devicetree/display-devicetree/display/qcm6490-sde-display-pinctrl.dtsi


QuecPi-QCLinux-BL01/src/devicetree/display-devicetree/display/qcm6490-sde-display.dtsi


QuecPi-QCLinux-BL01/src/qcom-6.6-overlay/arch/arm64/boot/dts/qcom/qcs6490-idp-pi.dts

  • display 设备树对应的 bb 文件

QuecPi-QCLinux-BL01/layers/meta-qcom-hwe/recipes-multimedia/display/qcom-displaydevicetree_git.bb


QuecPi-QCLinux-BL01/layers/meta-quectel/recipes-multimedia/display/qcom-displaydevicetree_git.bbappend

4. graphics

  • graphics 设备树

QuecPi-QCLinux-BL01/src/devicetree/graphics-devicetree/gpu/qcm6490-graphics.dtsi

  • graphics 设备树对应的 bb 文件

QuecPi-QCLinux-BL01/layers/meta-qcom-hwe/recipes-graphics/graphicsdevicetree/qcom-graphicsdevicetree_git.bb


QuecPi-QCLinux-BL01/layers/meta-quectel/recipes-graphics/graphicsdevicetree/qcom-graphicsdevicetree_git.bbappend

5. video

  • video 设备树

QuecPi-QCLinux-BL01/src/devicetree/video-devicetree/qcm6490-video.dtsi

  • video 设备树对应的 bb 文件

QuecPi-QCLinux-BL01/layers/meta-qcom-hwe/recipes-multimedia/video/qcom-videodtb_1.0.bb


QuecPi-QCLinux-BL01/layers/meta-quectel/recipes-multimedia/video/qcom-videodtb_1.0.bbappend