DSI device tree configuration

Italic text== Article purpose == 本文介绍了将外围设备分配给 Linux^® 操作系统时，如何配置DSI 的方法。 使用设备树机制 执行配置。

The Device tree 提供了STM32“ DSI Linux驱动程序”使用的DSI 的硬件描述。

DT bindings documentation

DSI由STM32 DSI设备树绑定表示 .

DT configuration

该硬件描述是STM32微处理器设备树文件（扩展名为.dtsi）和板子设备树文件（扩展名为.dts）的组合。 有关设备树文件分割的说明，请参见[ Device tree。

STM32CubeMX可用于生成板卡设备树。 有关更多详细信息，请参考How to configure the DT using STM32CubeMX.

DT configuration (STM32 level)

DSI设备树节点在stm32mp157c.dtsi中声明 . 声明（如下所示）定义了硬件寄存器的基地址，时钟和复位。

		dsi: dsi@5a000000 {
			compatible = "st,stm32-dsi";
			reg = <0x5a000000 0x800>;
			clocks = <&rcc DSI_K>, <&clk_hse>, <&rcc DSI_PX>;
			clock-names = "pclk", "ref", "px_clk";
			resets = <&rcc DSI_R>;
			reset-names = "apb";
			status = "disabled";
		};

该设备树部分与STM32微处理器有关。 它必须保持原样，而不能由最终用户修改。

DT configuration (board level)

与特定板卡相关的DSI设备树可能具有以下节点，具体取决于板卡硬件：

• dsi节点：包含输入/输出端口说明和一个panel子节点。
• ltdc节点：包含与dsi节点相关的输入/输出端口说明。
• panel_backlight节点：与面板节点有关。

[[STM32MP157x-EV1 - hardware description | 在stm32mp157c-ev1.dts中提供了设备树 .

&dsi {
	#address-cells = <1>;
	#size-cells = <0>;
	status = "okay";

	ports {
		#address-cells = <1>;
		#size-cells = <0>;

		port@0 {
			reg = <0>;
			dsi_in: endpoint {
				remote-endpoint = <&ltdc_ep0_out>;
			};
		};

		port@1 {
			reg = <1>;
			dsi_out: endpoint {
				remote-endpoint = <&panel_in>;
			};
		};
	};

	panel@0 {
		compatible = "raydium,rm68200";
		reg = <0>;
		reset-gpios = <&gpiof 15 GPIO_ACTIVE_LOW>;
		backlight = <&panel_backlight>;
		status = "okay";

		port {
			panel_in: endpoint {
				remote-endpoint = <&dsi_out>;
			};
		};
	};
};

&ltdc {
	status = "okay";

	port {
		#address-cells = <1>;
		#size-cells = <0>;

		ltdc_ep0_out: endpoint@0 {
			reg = <0>;
			remote-endpoint = <&dsi_in>;
		};
	};
};

...
	panel_backlight: panel-backlight {
		compatible = "gpio-backlight";
		gpios = <&gpiod 13 GPIO_ACTIVE_LOW>;
		default-on;
		status = "okay";
	};
};

How to configure the DT using STM32CubeMX

The STM32CubeMX 工具可用于配置STM32MPU设备并获取相应的platform configuration device tree文件.
STM32CubeMX可能不支持以上 DT bindings documentation 段中描述的所有属性。如果是这样，该工具会在生成的设备树中插入“用户部分”。 然后可以编辑这些部分以添加一些属性，并将它们一代一代地保留下来。 有关更多信息，请参见STM32CubeMX用户手册。

References

Please refer to the following links for additional information:

<securetransclude src="ProtectedTemplate:ArticleBasedOnModel" params="Peripheral or framework device tree configuration model"></securetransclude> <securetransclude src="ProtectedTemplate:PublicationRequestId" params="9161 | 2018-10-11 | BrunoB"></securetransclude>